home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / manageme / tcpdump-.7 / tcpdump- / tcpdump-richard-1.7 / libpcap-0.0 / pcap.h < prev    next >
Encoding:
C/C++ Source or Header  |  1995-04-14  |  6.1 KB  |  176 lines
  1. /*
  2.  * Copyright (c) 1993, 1994
  3.  *    The Regents of the University of California.  All rights reserved.
  4.  *
  5.  * Redistribution and use in source and binary forms, with or without
  6.  * modification, are permitted provided that the following conditions
  7.  * are met:
  8.  * 1. Redistributions of source code must retain the above copyright
  9.  *    notice, this list of conditions and the following disclaimer.
  10.  * 2. Redistributions in binary form must reproduce the above copyright
  11.  *    notice, this list of conditions and the following disclaimer in the
  12.  *    documentation and/or other materials provided with the distribution.
  13.  * 3. All advertising materials mentioning features or use of this software
  14.  *    must display the following acknowledgement:
  15.  *    This product includes software developed by the Computer Systems
  16.  *    Engineering Group at Lawrence Berkeley Laboratory.
  17.  * 4. Neither the name of the University nor of the Laboratory may be used
  18.  *    to endorse or promote products derived from this software without
  19.  *    specific prior written permission.
  20.  *
  21.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31.  * SUCH DAMAGE.
  32.  *
  33.  * @(#) $Header: pcap.h,v 1.15 94/06/14 20:03:34 leres Exp $ (LBL)
  34.  */
  35.  
  36. #ifndef lib_pcap_h
  37. #define lib_pcap_h
  38.  
  39. #include <sys/types.h>
  40. #include <sys/time.h>
  41.  
  42. #include <net/bpf.h>
  43.  
  44. #include <stdio.h>
  45.  
  46. #define PCAP_VERSION_MAJOR 2
  47. #define PCAP_VERSION_MINOR 4
  48.  
  49. #define PCAP_SNOOP_VERSION 2
  50.  
  51. #define FORMAT_TCPDUMP    1
  52. #define FORMAT_SNOOP2    2
  53.  
  54. #define PCAP_ERRBUF_SIZE 256
  55.  
  56. /*
  57.  * Compatibility for systems that have a bpf.h that
  58.  * predates the bpf typedefs for 64-bit support.
  59.  */
  60. #if BPF_RELEASE - 0 < 199406
  61. typedef    long bpf_int32;
  62. typedef    u_long bpf_u_int32;
  63. #endif
  64.  
  65. typedef struct pcap pcap_t;
  66. typedef struct pcap_dumper pcap_dumper_t;
  67.  
  68. /*
  69.  * The first record in the file contains saved values for some
  70.  * of the flags used in the printout phases of tcpdump.
  71.  * Many fields here are longs so compilers won't insert unwanted
  72.  * padding; these files need to be interchangeable across architectures.
  73.  */
  74. struct pcap_file_header {
  75.     bpf_u_int32 magic;
  76.     u_short version_major;
  77.     u_short version_minor;
  78.     bpf_int32 thiszone;    /* gmt to local correction */
  79.     bpf_u_int32 sigfigs;    /* accuracy of timestamps */
  80.     bpf_u_int32 snaplen;    /* max length saved portion of each pkt */
  81.     bpf_u_int32 linktype;    /* data link type (DLT_*) */
  82. };
  83.  
  84. struct pcap_file_snoop_header {
  85.     u_char id[8];        /* identification pattern */
  86.     bpf_u_int32 version;    /* version number */
  87.     bpf_u_int32 linktype;    /* datalink type */
  88. };
  89.  
  90. /*
  91.  * Each packet in the dump file is prepended with this generic header.
  92.  * This gets around the problem of different headers for different
  93.  * packet interfaces.
  94.  */
  95. struct pcap_pkthdr {
  96.     struct timeval ts;    /* time stamp */
  97.     bpf_u_int32 caplen;    /* length of portion present */
  98.     bpf_u_int32 len;    /* length this packet (off wire) */
  99. };
  100.  
  101. struct pcap_snoop_pkthdr {
  102.     bpf_u_int32 len;        /* original length */
  103.     bpf_u_int32 caplen;        /* included length */
  104.     bpf_u_int32 totlen;        /* packet record length */
  105.     bpf_u_int32 drops;        /* cumulative drops */
  106.     bpf_u_int32 secs;        /* timestamp seconds */
  107.     bpf_u_int32 usecs;        /* timestamp microseconds */
  108. };
  109.  
  110. /*
  111.  * Internally to libpcap we work with this header.
  112.  * It is the same as pcap_pkthdr plus a cumulative drops counter.
  113.  * Other extensions can be added here.
  114.  */
  115. struct pcap_hdr {
  116.     struct timeval ts;    /* time stamp */
  117.     bpf_u_int32 caplen;    /* length of portion present */
  118.     bpf_u_int32 len;    /* length this packet (off wire) */
  119.     bpf_u_int32 drops;    /* cumulative count of dropped packets */
  120. };
  121.  
  122. /*
  123.  * As returned by the pcap_stats()
  124.  */
  125. struct pcap_stat {
  126.     u_int ps_recv;        /* number of packets received */
  127.     u_int ps_drop;        /* number of packets dropped */
  128.     u_int ps_ifdrop;    /* drops by interface XXX not yet supported */
  129. };
  130.  
  131. typedef void (*pcap_handler)(u_char *, const struct pcap_hdr *, const u_char *);
  132.  
  133. char    *pcap_lookupdev(char *);
  134. int    pcap_lookupnet(char *, u_long *, u_long *, char *);
  135. pcap_t    *pcap_open_live(char *, int, int, int, char *);
  136. pcap_t    *pcap_open_offline(char *, int, char *);
  137. void    pcap_close(pcap_t *);
  138. int    pcap_loop(pcap_t *, int, pcap_handler, u_char *);
  139. int    pcap_dispatch(pcap_t *, int, pcap_handler, u_char *);
  140. const u_char* pcap_next(pcap_t *, struct pcap_hdr *);
  141. int    pcap_stats(pcap_t *, struct pcap_stat *);
  142. int pcap_stats_live(pcap_t * p, struct pcap_stat *ps);
  143. int pcap_stats_offline(pcap_t * p, struct pcap_stat *ps);
  144. int    pcap_setfilter(pcap_t *, struct bpf_program *);
  145. int    pcap_setfilter_live(pcap_t *, struct bpf_program *);
  146. int    pcap_setfilter_offline(pcap_t *, struct bpf_program *);
  147. void    pcap_perror(pcap_t *, char *);
  148. char    *pcap_strerror(int);
  149. char    *pcap_geterr(pcap_t *);
  150. int    pcap_compile(pcap_t *, struct bpf_program *, char *, int, u_long);
  151. int    pcap_compile_offline(char *, struct bpf_program *, int, int, u_long, int);
  152. /* XXX */
  153. int    pcap_freecode(pcap_t *, struct bpf_program *);
  154. int    pcap_datalink(pcap_t *);
  155. int    pcap_snapshot(pcap_t *);
  156. int    pcap_is_swapped(pcap_t *);
  157. int    pcap_major_version(pcap_t *);
  158. int    pcap_minor_version(pcap_t *);
  159.  
  160. /* XXX */
  161. int    pcap_read_offline(pcap_t *, int, pcap_handler, u_char *);
  162. int    pcap_read_live(pcap_t *, int cnt, pcap_handler, u_char *);
  163.  
  164. FILE    *pcap_file(pcap_t *);
  165. int    pcap_fileno(pcap_t *);
  166.  
  167. pcap_dumper_t *pcap_dump_open(pcap_t *, char *, int);
  168. void    pcap_dump_close(pcap_dumper_t *);
  169. void    pcap_dump(u_char *, const struct pcap_hdr *, const u_char *);
  170.  
  171. /* XXX this guy lives in the bpf tree */
  172. u_int    bpf_filter(struct bpf_insn *, u_char *, u_int, u_int);
  173. char    *bpf_image(struct bpf_insn *, int);
  174.  
  175. #endif
  176.